home *** CD-ROM | disk | FTP | other *** search
/ Sun Solutions 1997 April to September / Sun Solutions CD - APR '97 - SEP '97 (704-3778-12 Rev. H)(Sun Microsystems, Inc.)(1997).iso / products / Confluent / note_preferences.txt < prev    next >
Text File  |  1995-10-17  |  7KB  |  208 lines
  1. ----------------------------------------------------------------------
  2. Visual Thought Preferences
  3.  
  4. Last update: 10 September 1995
  5.  
  6. Confluent Technical Notes
  7. Copyright (c) 1995 Confluent, Inc.  All rights reserved.
  8. Suggestions or questions to 415-586-8700 or vthought@confluent.com.
  9. ----------------------------------------------------------------------
  10.  
  11. This technical note describes the command-line and startup preferences
  12. that can be specified for Visual Thought.
  13.  
  14. Visual Thought recognizes the following preferences:
  15.  
  16.   background        : background color used to draw dialogs
  17.   encoding          : enable printing of ISO-8859-1 characters above 127
  18.   font              : font used to display text in dialogs
  19.   foreground        : foreground color used to draw dialogs
  20.   informtranslators : generate messages for unavailable translator commands
  21.   laf               : look-and-feel used for interface appearance and behavior
  22.   monochrome        : use only black and white for display on monochrome monitors
  23.   nosoundalert      : disable alert indicating unavailable audio control device
  24.   printclass        : type of PostScript printer (standard or color)
  25.   printcmd          : command for printing PostScript documents
  26.  
  27. The available preferences are described in more detail in the section
  28. "Preference Descriptions" below.
  29.  
  30.  
  31. Specifying Preferences
  32. ----------------------
  33. Visual Thought preferences can be set in the following ways:
  34.  
  35.  1. Modify the X server resource database (i.e., in ~/.Xdefaults or
  36.     via xrdb) with an entry of the form:
  37.  
  38.       vthoughtx.<name>: <value>
  39.  
  40.  2. Add arguments to the vthought command line of the form:
  41.  
  42.       -<name> <value>
  43.  
  44. If a preference is specified through both the X server resource
  45. database and the command line, the value on the command line takes
  46. precedence.  Some preferences can only be specified on the command
  47. line.  These are noted in the section "Preference Descriptions" below.
  48.  
  49. As an example, to use a 14 pt Helvetica font for dialog interface
  50. controls, either place the following in ~/.Xdefaults:
  51.  
  52.   vthoughtx.font: family:helvetica-size:14
  53.  
  54. or run Visual Thought with:
  55.  
  56.   vthought -font family:helvetica-size:14
  57.  
  58.  
  59. Preference Descriptions
  60. -----------------------
  61.  
  62.   Name: background
  63.   Values: depends on the colors available from X - typical values are:
  64.             red, green, blue, #ff0000, #00ff00, #0000ff
  65.   Default: gray80
  66.   Command line: -background <name>
  67.  
  68.   The background color used to draw dialogs.  The color can be
  69.   specified in any format recognized by the X server (e.g., "#ff0000",
  70.   "red").
  71.  
  72.   This preference can only be specified on the command line.
  73.  
  74.  
  75.   Name: encoding
  76.   Values: latin1, standard
  77.   Default: standard
  78.   X resource:   vthoughtx.encoding: <name>
  79.   Command line: -encoding <name>
  80.  
  81.   With a value of "latin1", characters in the ISO-8859-1 character set
  82.   with codes greater than 127 are printed correctly.  This is
  83.   accomplished by modifying the PostScript output to change font
  84.   encoding vectors from StandardEncoding to an encoding vector for the
  85.   ISO-8859-1 character set.  This option is typically used to enable
  86.   Visual Thought to correctly print 8-bit multinational characters
  87.   from European languages.
  88.  
  89.   This option should only be used if it is necessary to print
  90.   ISO-8859-1 characters with character codes greater than 127.  It may
  91.   affect printing performance and could potentially fail on some
  92.   printers.
  93.  
  94.  
  95.   Name: font
  96.   Values: depends on the fonts available from X - typical names are:
  97.             avantgarde, bembo, bookman, charter, clean, courier, fixed,
  98.             gill, helvetica, lucida, menu, new century schoolbook, palatino,
  99.             rockwell, terminal, times
  100.   Default: family:helvetica-size:12
  101.   Command line: -font family:<name>-size:<value>
  102.  
  103.   The font used to display text in Visual Thought dialogs.  It is
  104.   recommended that the font size match a font size available from the X
  105.   server.  Font sizes much greater than 12 can make Visual Thought
  106.   dialogs difficult to use.
  107.  
  108.   The available fonts can be determined with xlsfonts.  For example, the
  109.   following will list the available medium Helvetica fonts:
  110.  
  111.     xlsfonts '*helvetica-medium-r-normal*'
  112.  
  113.   This preference can only be specified on the command line.
  114.  
  115.  
  116.   Name: foreground
  117.   Values: depends on the colors available from X - typical values are:
  118.             red, green, blue, #ff0000, #00ff00, #0000ff
  119.   Default: black
  120.   Command line: -foreground <name>
  121.  
  122.   The foreground color used to draw dialogs.  The color can be
  123.   specified in any format recognized by the X server (e.g., "#ff0000",
  124.   "red").
  125.  
  126.   This preference can only be specified on the command line.
  127.  
  128.  
  129.   Name: informtranslators
  130.   Values: on
  131.   Default:
  132.   X resource:   vthoughtx.informtranslators: on
  133.   Command line: -informtranslators
  134.  
  135.   If this preference is specified, informational messages are generated
  136.   when format translator commands specified in the Translators file are
  137.   not available.  Turning informational messages on is helpful for
  138.   debugging purposes when modifying the Translators file to add, change,
  139.   or delete file export translators available to Visual Thought.
  140.  
  141.  
  142.   Name: laf
  143.   Values: motif, openlook, windows, cua
  144.   Default: motif
  145.   Command line: -laf <name>
  146.  
  147.   The look-and-feel used for the Visual Thought interface appearance
  148.   and behavior.
  149.  
  150.   This preference can only be specified on the command line.
  151.  
  152.  
  153.   Name: monochrome
  154.   Values: on
  155.   Default:
  156.   X resource:   vthoughtx.monochrome: on
  157.   Command line: -monochrome
  158.  
  159.   If this preference is specified, all dialogs are drawn using only
  160.   black and white, with dithering used to represent gray scales in some
  161.   cases.  This preference should be specified when Visual Thought is
  162.   being displayed on a monochrome monitor.
  163.  
  164.  
  165.   Name: nosoundalert
  166.   Values: on
  167.   Default:
  168.   X resource:   vthoughtx.nosoundalert: on
  169.   Command line: -nosoundalert
  170.  
  171.   If this preference is specified, no alert notice is displayed at
  172.   startup if the audio control device (/dev/audioctl) cannot be opened.
  173.   Turning "nosoundalert" on is useful to avoid alert notices on startup
  174.   if the host machine is intended not have an audio control device,
  175.   or access to the audio control device is to be restricted.
  176.  
  177.  
  178.   Name: printclass
  179.   Values: vprintPS, vprintColorPS
  180.   Default: vprintPS
  181.   X resource:   vthoughtx.printclass: <name>
  182.   Command line: -printclass <name>
  183.  
  184.   With the default value of "vprintPS", printed and Encapsulated
  185.   PostScript output is generated using standard Level 1 PostScript.
  186.   Color raster images (e.g., GIF images) are output using gray scales.
  187.   This output is compatible with Level 1 PostScript printers.
  188.  
  189.   With a value of "vprintColorPS", printed and Encapsulated PostScript
  190.   output is generated using Level 1 PostScript with color extensions
  191.   (i.e., the colorimage operator).  Color raster images (e.g., GIF
  192.   images) are output in color.  This output is compatible with Level 2
  193.   PostScript printers and color Level 1 PostScript printers with color
  194.   extensions.  This option should be used for the output of documents
  195.   containing color raster images.
  196.  
  197.  
  198.   Name: printcmd
  199.   Values: lp, lpr
  200.   Default: lpr
  201.   X resource:   vthoughtx.printcmd: <command>
  202.   Command line: -printcmd <command>
  203.  
  204.   The print command used to print documents to a PostScript printer.
  205.   Printing is accomplished by executing the print command after setting
  206.   the PRINTER environment variable to the printer specified in the Print
  207.   dialog.
  208.